<?xml version="1.0" encoding="ascii"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
          "DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
<head>
  <title>s3.objects</title>
  <link rel="stylesheet" href="epydoc.css" type="text/css" />
  <script type="text/javascript" src="epydoc.js"></script>
</head>

<body bgcolor="white" text="black" link="blue" vlink="#204080"
      alink="#204080">
<!-- ==================== NAVIGATION BAR ==================== -->
<table class="navbar" border="0" width="100%" cellpadding="0"
       bgcolor="#a0c0ff" cellspacing="0">
  <tr valign="middle">
  <!-- Home link -->
      <th>&nbsp;&nbsp;&nbsp;<a
        href="s3-module.html">Home</a>&nbsp;&nbsp;&nbsp;</th>

  <!-- Tree link -->
      <th>&nbsp;&nbsp;&nbsp;<a
        href="module-tree.html">Trees</a>&nbsp;&nbsp;&nbsp;</th>

  <!-- Index link -->
      <th>&nbsp;&nbsp;&nbsp;<a
        href="identifier-index.html">Indices</a>&nbsp;&nbsp;&nbsp;</th>

  <!-- Help link -->
      <th>&nbsp;&nbsp;&nbsp;<a
        href="help.html">Help</a>&nbsp;&nbsp;&nbsp;</th>

      <th class="navbar" width="100%"></th>
  </tr>
</table>
<table width="100%" cellpadding="0" cellspacing="0">
  <tr valign="top">
    <td width="100%">
      <span class="breadcrumbs">
        <a href="s3-module.html">Package&nbsp;s3</a> ::
        Module&nbsp;objects
      </span>
    </td>
    <td>
      <table cellpadding="0" cellspacing="0">
        <!-- hide/show private -->
        <tr><td align="right"><span class="options">[<a href="javascript:void(0);" class="privatelink"
    onclick="toggle_private();">hide private</a>]</span></td></tr>
        <tr><td align="right"><span class="options"
            >[<a href="frames.html" target="_top">frames</a
            >]&nbsp;|&nbsp;<a href="s3.objects-pysrc.html"
            target="_top">no&nbsp;frames</a>]</span></td></tr>
      </table>
    </td>
  </tr>
</table>
<h1 class="epydoc">Source Code for <a href="s3.objects-module.html">Module s3.objects</a></h1>
<pre class="py-src">
<tt class="py-lineno">  1</tt>  <tt class="py-line"><tt class="py-keyword">from</tt> <tt class="py-name">StringIO</tt> <tt class="py-keyword">import</tt> <tt class="py-name">StringIO</tt> </tt>
<tt class="py-lineno">  2</tt>  <tt class="py-line"><tt class="py-keyword">from</tt> <tt id="link-0" class="py-name" targets="Package s3=s3-module.html"><a title="s3" class="py-name" href="#" onclick="return doclink('link-0', 's3', 'link-0');">s3</a></tt></tt><tt class="py-op">.</tt><tt id="link-1" class="py-name" targets="Module s3.errors=s3.errors-module.html"><a title="s3.errors" class="py-name" href="#" onclick="return doclink('link-1', 'errors', 'link-1');">errors</a></tt></tt> <tt class="py-keyword">import</tt> <tt id="link-2" class="py-name" targets="Class s3.errors.S3Error=s3.errors.S3Error-class.html"><a title="s3.errors.S3Error" class="py-name" href="#" onclick="return doclink('link-2', 'S3Error', 'link-2');">S3Error</a></tt></tt> </tt>
<tt class="py-lineno">  3</tt>  <tt class="py-line"><tt class="py-keyword">from</tt> <tt id="link-3" class="py-name"><a title="s3" class="py-name" href="#" onclick="return doclink('link-3', 's3', 'link-0');">s3</a></tt></tt><tt class="py-op">.</tt><tt id="link-4" class="py-name" targets="Module s3.parsers=s3.parsers-module.html"><a title="s3.parsers" class="py-name" href="#" onclick="return doclink('link-4', 'parsers', 'link-4');">parsers</a></tt></tt> <tt class="py-keyword">import</tt> <tt id="link-5" class="py-name" targets="Function s3.parsers.parseListKeys()=s3.parsers-module.html#parseListKeys"><a title="s3.parsers.parseListKeys" class="py-name" href="#" onclick="return doclink('link-5', 'parseListKeys', 'link-5');">parseListKeys</a></tt></tt> </tt>
<tt class="py-lineno">  4</tt>  <tt class="py-line"> </tt>
<a name="S3Object"></a><div id="S3Object-def"><tt class="py-lineno">  5</tt> <a class="py-toggle" href="#" id="S3Object-toggle" onclick="return toggle('S3Object');">-</a><tt class="py-line"><tt class="py-keyword">class</tt> <a class="py-def-name" href="s3.objects.S3Object-class.html">S3Object</a><tt class="py-op">(</tt><tt class="py-base-class">object</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
</div><div id="S3Object-collapsed" style="display:none;" pad="+++" indent="++++"></div><div id="S3Object-expanded"><tt class="py-lineno">  6</tt>  <tt class="py-line">    <tt class="py-docstring">"""</tt> </tt>
<tt class="py-lineno">  7</tt>  <tt class="py-line"><tt class="py-docstring">    S3Object class</tt> </tt>
<tt class="py-lineno">  8</tt>  <tt class="py-line"><tt class="py-docstring">    """</tt> </tt>
<a name="S3Object.__init__"></a><div id="S3Object.__init__-def"><tt class="py-lineno">  9</tt> <a class="py-toggle" href="#" id="S3Object.__init__-toggle" onclick="return toggle('S3Object.__init__');">-</a><tt class="py-line">    <tt class="py-keyword">def</tt> <a class="py-def-name" href="s3.objects.S3Object-class.html#__init__">__init__</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">key</tt><tt class="py-op">,</tt> <tt class="py-param">data</tt><tt class="py-op">,</tt> <tt class="py-param">metadata</tt><tt class="py-op">,</tt> <tt class="py-param">last_modified</tt><tt class="py-op">=</tt><tt class="py-name">None</tt><tt class="py-op">,</tt> <tt class="py-param">bucket</tt><tt class="py-op">=</tt><tt class="py-name">None</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
</div><div id="S3Object.__init__-collapsed" style="display:none;" pad="+++" indent="++++++++"></div><div id="S3Object.__init__-expanded"><tt class="py-lineno"> 10</tt>  <tt class="py-line">        <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">key</tt> <tt class="py-op">=</tt> <tt class="py-name">key</tt> </tt>
<tt class="py-lineno"> 11</tt>  <tt class="py-line">        <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">data</tt> <tt class="py-op">=</tt> <tt class="py-name">data</tt> </tt>
<tt class="py-lineno"> 12</tt>  <tt class="py-line">        <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">metadata</tt> <tt class="py-op">=</tt> <tt class="py-op">{</tt><tt class="py-op">}</tt> </tt>
<tt class="py-lineno"> 13</tt>  <tt class="py-line">        <tt class="py-keyword">for</tt> <tt class="py-name">key</tt> <tt class="py-keyword">in</tt> <tt class="py-name">metadata</tt><tt class="py-op">:</tt> </tt>
<tt class="py-lineno"> 14</tt>  <tt class="py-line">            <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">metadata</tt><tt class="py-op">[</tt><tt class="py-name">key</tt><tt class="py-op">.</tt><tt class="py-name">lower</tt><tt class="py-op">(</tt><tt class="py-op">)</tt><tt class="py-op">]</tt> <tt class="py-op">=</tt> <tt class="py-name">metadata</tt><tt class="py-op">[</tt><tt class="py-name">key</tt><tt class="py-op">]</tt> </tt>
<tt class="py-lineno"> 15</tt>  <tt class="py-line">        <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">last_modified</tt> <tt class="py-op">=</tt> <tt class="py-name">last_modified</tt> </tt>
<tt class="py-lineno"> 16</tt>  <tt class="py-line">        <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">_bucket</tt> <tt class="py-op">=</tt> <tt class="py-name">bucket</tt> </tt>
</div><tt class="py-lineno"> 17</tt>  <tt class="py-line">     </tt>
<a name="S3Object.__repr__"></a><div id="S3Object.__repr__-def"><tt class="py-lineno"> 18</tt> <a class="py-toggle" href="#" id="S3Object.__repr__-toggle" onclick="return toggle('S3Object.__repr__');">-</a><tt class="py-line">    <tt class="py-keyword">def</tt> <a class="py-def-name" href="s3.objects.S3Object-class.html#__repr__">__repr__</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
</div><div id="S3Object.__repr__-collapsed" style="display:none;" pad="+++" indent="++++++++"></div><div id="S3Object.__repr__-expanded"><tt class="py-lineno"> 19</tt>  <tt class="py-line">        <tt class="py-keyword">return</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">key</tt> </tt>
</div><tt class="py-lineno"> 20</tt>  <tt class="py-line">     </tt>
<a name="S3Object.__str__"></a><div id="S3Object.__str__-def"><tt class="py-lineno"> 21</tt> <a class="py-toggle" href="#" id="S3Object.__str__-toggle" onclick="return toggle('S3Object.__str__');">-</a><tt class="py-line">    <tt class="py-keyword">def</tt> <a class="py-def-name" href="s3.objects.S3Object-class.html#__str__">__str__</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
</div><div id="S3Object.__str__-collapsed" style="display:none;" pad="+++" indent="++++++++"></div><div id="S3Object.__str__-expanded"><tt class="py-lineno"> 22</tt>  <tt class="py-line">        <tt class="py-keyword">return</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">key</tt> </tt>
</div><tt class="py-lineno"> 23</tt>  <tt class="py-line">     </tt>
<a name="S3Object.save"></a><div id="S3Object.save-def"><tt class="py-lineno"> 24</tt> <a class="py-toggle" href="#" id="S3Object.save-toggle" onclick="return toggle('S3Object.save');">-</a><tt class="py-line">    <tt class="py-keyword">def</tt> <a class="py-def-name" href="s3.objects.S3Object-class.html#save">save</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
</div><div id="S3Object.save-collapsed" style="display:none;" pad="+++" indent="++++++++"></div><div id="S3Object.save-expanded"><tt class="py-lineno"> 25</tt>  <tt class="py-line">        <tt class="py-docstring">"""</tt> </tt>
<tt class="py-lineno"> 26</tt>  <tt class="py-line"><tt class="py-docstring">        Save a modified (or same) S3Object to the bucket associated with it.</tt> </tt>
<tt class="py-lineno"> 27</tt>  <tt class="py-line"><tt class="py-docstring">        """</tt> </tt>
<tt class="py-lineno"> 28</tt>  <tt class="py-line">        <tt class="py-keyword">if</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">_bucket</tt><tt class="py-op">:</tt> </tt>
<tt class="py-lineno"> 29</tt>  <tt class="py-line">            <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">_bucket</tt><tt class="py-op">.</tt><tt id="link-6" class="py-name" targets="Method s3.objects.S3Bucket.save()=s3.objects.S3Bucket-class.html#save,Method s3.objects.S3Object.save()=s3.objects.S3Object-class.html#save"><a title="s3.objects.S3Bucket.save
s3.objects.S3Object.save" class="py-name" href="#" onclick="return doclink('link-6', 'save', 'link-6');">save</a></tt></tt><tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">)</tt> </tt>
<tt class="py-lineno"> 30</tt>  <tt class="py-line">        <tt class="py-keyword">else</tt><tt class="py-op">:</tt> </tt>
<tt class="py-lineno"> 31</tt>  <tt class="py-line">            <tt class="py-keyword">raise</tt> <tt id="link-7" class="py-name"><a title="s3.errors.S3Error" class="py-name" href="#" onclick="return doclink('link-7', 'S3Error', 'link-2');">S3Error</a></tt></tt><tt class="py-op">(</tt><tt class="py-string">'No bucket selected'</tt><tt class="py-op">,</tt> <tt class="py-string">'Object has no bucket associated with itself'</tt><tt class="py-op">,</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">key</tt><tt class="py-op">)</tt> </tt>
</div><tt class="py-lineno"> 32</tt>  <tt class="py-line"> </tt>
<a name="S3Object.delete"></a><div id="S3Object.delete-def"><tt class="py-lineno"> 33</tt> <a class="py-toggle" href="#" id="S3Object.delete-toggle" onclick="return toggle('S3Object.delete');">-</a><tt class="py-line">    <tt class="py-keyword">def</tt> <a class="py-def-name" href="s3.objects.S3Object-class.html#delete">delete</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
</div><div id="S3Object.delete-collapsed" style="display:none;" pad="+++" indent="++++++++"></div><div id="S3Object.delete-expanded"><tt class="py-lineno"> 34</tt>  <tt class="py-line">        <tt class="py-docstring">"""</tt> </tt>
<tt class="py-lineno"> 35</tt>  <tt class="py-line"><tt class="py-docstring">        Deletes an S3Object from the bucket.</tt> </tt>
<tt class="py-lineno"> 36</tt>  <tt class="py-line"><tt class="py-docstring">        """</tt> </tt>
<tt class="py-lineno"> 37</tt>  <tt class="py-line">        <tt class="py-keyword">if</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">_bucket</tt><tt class="py-op">:</tt> </tt>
<tt class="py-lineno"> 38</tt>  <tt class="py-line">            <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">_bucket</tt><tt class="py-op">.</tt><tt id="link-8" class="py-name" targets="Method s3.generator.S3Generator.delete()=s3.generator.S3Generator-class.html#delete,Method s3.objects.S3Bucket.delete()=s3.objects.S3Bucket-class.html#delete,Method s3.objects.S3Object.delete()=s3.objects.S3Object-class.html#delete,Method s3.service.S3Service.delete()=s3.service.S3Service-class.html#delete"><a title="s3.generator.S3Generator.delete
s3.objects.S3Bucket.delete
s3.objects.S3Object.delete
s3.service.S3Service.delete" class="py-name" href="#" onclick="return doclink('link-8', 'delete', 'link-8');">delete</a></tt></tt><tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">)</tt> </tt>
<tt class="py-lineno"> 39</tt>  <tt class="py-line">        <tt class="py-keyword">else</tt><tt class="py-op">:</tt> </tt>
<tt class="py-lineno"> 40</tt>  <tt class="py-line">            <tt class="py-keyword">raise</tt> <tt id="link-9" class="py-name"><a title="s3.errors.S3Error" class="py-name" href="#" onclick="return doclink('link-9', 'S3Error', 'link-2');">S3Error</a></tt></tt><tt class="py-op">(</tt><tt class="py-string">'No bucket selected'</tt><tt class="py-op">,</tt> <tt class="py-string">'Object has no bucket associated with itself'</tt><tt class="py-op">,</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">key</tt><tt class="py-op">)</tt> </tt>
</div><tt class="py-lineno"> 41</tt>  <tt class="py-line"> </tt>
<tt class="py-lineno"> 42</tt>  <tt class="py-line"> </tt>
<a name="S3Object.get_meta_for_headers"></a><div id="S3Object.get_meta_for_headers-def"><tt class="py-lineno"> 43</tt> <a class="py-toggle" href="#" id="S3Object.get_meta_for_headers-toggle" onclick="return toggle('S3Object.get_meta_for_headers');">-</a><tt class="py-line">    <tt class="py-keyword">def</tt> <a class="py-def-name" href="s3.objects.S3Object-class.html#get_meta_for_headers">get_meta_for_headers</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
</div><div id="S3Object.get_meta_for_headers-collapsed" style="display:none;" pad="+++" indent="++++++++"></div><div id="S3Object.get_meta_for_headers-expanded"><tt class="py-lineno"> 44</tt>  <tt class="py-line">        <tt class="py-docstring">"""</tt> </tt>
<tt class="py-lineno"> 45</tt>  <tt class="py-line"><tt class="py-docstring">        Returns a dictionary of metadata keys prepared for inserting them into headers.</tt> </tt>
<tt class="py-lineno"> 46</tt>  <tt class="py-line"><tt class="py-docstring">        """</tt> </tt>
<tt class="py-lineno"> 47</tt>  <tt class="py-line">        <tt class="py-name">headers</tt> <tt class="py-op">=</tt> <tt class="py-op">{</tt><tt class="py-op">}</tt> </tt>
<tt class="py-lineno"> 48</tt>  <tt class="py-line">        <tt class="py-keyword">for</tt> <tt class="py-name">key</tt> <tt class="py-keyword">in</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">metadata</tt><tt class="py-op">:</tt> </tt>
<tt class="py-lineno"> 49</tt>  <tt class="py-line">            <tt class="py-name">headers</tt><tt class="py-op">[</tt><tt class="py-string">'x-amz-meta-'</tt> <tt class="py-op">+</tt> <tt class="py-name">key</tt><tt class="py-op">]</tt> <tt class="py-op">=</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">metadata</tt><tt class="py-op">[</tt><tt class="py-name">key</tt><tt class="py-op">]</tt> </tt>
<tt class="py-lineno"> 50</tt>  <tt class="py-line">        <tt class="py-keyword">return</tt> <tt class="py-name">headers</tt> </tt>
</div></div><tt class="py-lineno"> 51</tt>  <tt class="py-line"> </tt>
<tt class="py-lineno"> 52</tt>  <tt class="py-line"> </tt>
<a name="S3Bucket"></a><div id="S3Bucket-def"><tt class="py-lineno"> 53</tt> <a class="py-toggle" href="#" id="S3Bucket-toggle" onclick="return toggle('S3Bucket');">-</a><tt class="py-line"><tt class="py-keyword">class</tt> <a class="py-def-name" href="s3.objects.S3Bucket-class.html">S3Bucket</a><tt class="py-op">(</tt><tt class="py-base-class">object</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
</div><div id="S3Bucket-collapsed" style="display:none;" pad="+++" indent="++++"></div><div id="S3Bucket-expanded"><tt class="py-lineno"> 54</tt>  <tt class="py-line">    <tt class="py-docstring">"""</tt> </tt>
<tt class="py-lineno"> 55</tt>  <tt class="py-line"><tt class="py-docstring">    S3Bucket class</tt> </tt>
<tt class="py-lineno"> 56</tt>  <tt class="py-line"><tt class="py-docstring">    </tt> </tt>
<tt class="py-lineno"> 57</tt>  <tt class="py-line"><tt class="py-docstring">    Behaves like a dictionary of keys in the bucket, with some additional methods.</tt> </tt>
<tt class="py-lineno"> 58</tt>  <tt class="py-line"><tt class="py-docstring">    """</tt> </tt>
<tt class="py-lineno"> 59</tt>  <tt class="py-line">     </tt>
<a name="S3Bucket.__init__"></a><div id="S3Bucket.__init__-def"><tt class="py-lineno"> 60</tt> <a class="py-toggle" href="#" id="S3Bucket.__init__-toggle" onclick="return toggle('S3Bucket.__init__');">-</a><tt class="py-line">    <tt class="py-keyword">def</tt> <a class="py-def-name" href="s3.objects.S3Bucket-class.html#__init__">__init__</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">name</tt><tt class="py-op">,</tt> <tt class="py-param">connection</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
</div><div id="S3Bucket.__init__-collapsed" style="display:none;" pad="+++" indent="++++++++"></div><div id="S3Bucket.__init__-expanded"><tt class="py-lineno"> 61</tt>  <tt class="py-line">        <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">name</tt> <tt class="py-op">=</tt> <tt class="py-name">name</tt> </tt>
<tt class="py-lineno"> 62</tt>  <tt class="py-line">        <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">_s3_conn</tt> <tt class="py-op">=</tt> <tt id="link-10" class="py-name" targets="Module s3.connection=s3.connection-module.html"><a title="s3.connection" class="py-name" href="#" onclick="return doclink('link-10', 'connection', 'link-10');">connection</a></tt></tt> </tt>
</div><tt class="py-lineno"> 63</tt>  <tt class="py-line"> </tt>
<a name="S3Bucket._request"></a><div id="S3Bucket._request-def"><tt class="py-lineno"> 64</tt> <a class="py-toggle" href="#" id="S3Bucket._request-toggle" onclick="return toggle('S3Bucket._request');">-</a><tt class="py-line">    <tt class="py-keyword">def</tt> <a class="py-def-name" href="s3.objects.S3Bucket-class.html#_request">_request</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">method</tt><tt class="py-op">=</tt><tt class="py-string">''</tt><tt class="py-op">,</tt> <tt class="py-param">obj</tt><tt class="py-op">=</tt><tt class="py-name">None</tt><tt class="py-op">,</tt> <tt class="py-param">send_io</tt><tt class="py-op">=</tt><tt class="py-name">None</tt><tt class="py-op">,</tt> <tt class="py-param">params</tt><tt class="py-op">=</tt><tt class="py-name">None</tt><tt class="py-op">,</tt> <tt class="py-param">headers</tt><tt class="py-op">=</tt><tt class="py-name">None</tt><tt class="py-op">,</tt> <tt class="py-op">*</tt><tt class="py-param">args</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
</div><div id="S3Bucket._request-collapsed" style="display:none;" pad="+++" indent="++++++++"></div><div id="S3Bucket._request-expanded"><tt class="py-lineno"> 65</tt>  <tt class="py-line">        <tt class="py-keyword">return</tt> <tt class="py-name">getattr</tt><tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">_s3_conn</tt><tt class="py-op">.</tt><tt id="link-11" class="py-name" targets="Method s3.connection.S3Connection.clone()=s3.connection.S3Connection-class.html#clone"><a title="s3.connection.S3Connection.clone" class="py-name" href="#" onclick="return doclink('link-11', 'clone', 'link-11');">clone</a></tt></tt><tt class="py-op">(</tt><tt class="py-op">)</tt><tt class="py-op">,</tt> <tt class="py-name">method</tt><tt class="py-op">)</tt><tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">name</tt><tt class="py-op">,</tt> <tt class="py-name">obj</tt><tt class="py-op">,</tt> <tt class="py-name">send_io</tt><tt class="py-op">=</tt><tt class="py-name">send_io</tt><tt class="py-op">,</tt> </tt>
<tt class="py-lineno"> 66</tt>  <tt class="py-line">                                              <tt class="py-name">params</tt><tt class="py-op">=</tt><tt class="py-name">params</tt><tt class="py-op">,</tt> <tt class="py-name">headers</tt><tt class="py-op">=</tt><tt class="py-name">headers</tt><tt class="py-op">,</tt> </tt>
<tt class="py-lineno"> 67</tt>  <tt class="py-line">                                              <tt class="py-op">*</tt><tt class="py-name">args</tt><tt class="py-op">)</tt> </tt>
</div><tt class="py-lineno"> 68</tt>  <tt class="py-line"> </tt>
<a name="S3Bucket.__str__"></a><div id="S3Bucket.__str__-def"><tt class="py-lineno"> 69</tt> <a class="py-toggle" href="#" id="S3Bucket.__str__-toggle" onclick="return toggle('S3Bucket.__str__');">-</a><tt class="py-line">    <tt class="py-keyword">def</tt> <a class="py-def-name" href="s3.objects.S3Bucket-class.html#__str__">__str__</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
</div><div id="S3Bucket.__str__-collapsed" style="display:none;" pad="+++" indent="++++++++"></div><div id="S3Bucket.__str__-expanded"><tt class="py-lineno"> 70</tt>  <tt class="py-line">        <tt class="py-keyword">return</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">name</tt> </tt>
</div><tt class="py-lineno"> 71</tt>  <tt class="py-line">     </tt>
<a name="S3Bucket.__repr__"></a><div id="S3Bucket.__repr__-def"><tt class="py-lineno"> 72</tt> <a class="py-toggle" href="#" id="S3Bucket.__repr__-toggle" onclick="return toggle('S3Bucket.__repr__');">-</a><tt class="py-line">    <tt class="py-keyword">def</tt> <a class="py-def-name" href="s3.objects.S3Bucket-class.html#__repr__">__repr__</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
</div><div id="S3Bucket.__repr__-collapsed" style="display:none;" pad="+++" indent="++++++++"></div><div id="S3Bucket.__repr__-expanded"><tt class="py-lineno"> 73</tt>  <tt class="py-line">        <tt class="py-keyword">return</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">name</tt> </tt>
</div><tt class="py-lineno"> 74</tt>  <tt class="py-line"> </tt>
<tt class="py-lineno"> 75</tt>  <tt class="py-line"> </tt>
<a name="S3Bucket.get"></a><div id="S3Bucket.get-def"><tt class="py-lineno"> 76</tt> <a class="py-toggle" href="#" id="S3Bucket.get-toggle" onclick="return toggle('S3Bucket.get');">-</a><tt class="py-line">    <tt class="py-keyword">def</tt> <a class="py-def-name" href="s3.objects.S3Bucket-class.html#get">get</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">key</tt><tt class="py-op">,</tt> <tt class="py-param">headers</tt><tt class="py-op">=</tt><tt class="py-op">{</tt><tt class="py-op">}</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
</div><div id="S3Bucket.get-collapsed" style="display:none;" pad="+++" indent="++++++++"></div><div id="S3Bucket.get-expanded"><tt class="py-lineno"> 77</tt>  <tt class="py-line">        <tt class="py-docstring">"""</tt> </tt>
<tt class="py-lineno"> 78</tt>  <tt class="py-line"><tt class="py-docstring">        Get an S3Object from the bucket.</tt> </tt>
<tt class="py-lineno"> 79</tt>  <tt class="py-line"><tt class="py-docstring">        </tt> </tt>
<tt class="py-lineno"> 80</tt>  <tt class="py-line"><tt class="py-docstring">        @param key:     Key of the object</tt> </tt>
<tt class="py-lineno"> 81</tt>  <tt class="py-line"><tt class="py-docstring">        @type  key:     string</tt> </tt>
<tt class="py-lineno"> 82</tt>  <tt class="py-line"><tt class="py-docstring">        @param headers: Dictionary of additional headers</tt> </tt>
<tt class="py-lineno"> 83</tt>  <tt class="py-line"><tt class="py-docstring">        @type  headers: dict</tt> </tt>
<tt class="py-lineno"> 84</tt>  <tt class="py-line"><tt class="py-docstring">        @return:        Selected S3Object if found or None</tt> </tt>
<tt class="py-lineno"> 85</tt>  <tt class="py-line"><tt class="py-docstring">        @rtype:         S3Object</tt> </tt>
<tt class="py-lineno"> 86</tt>  <tt class="py-line"><tt class="py-docstring">        """</tt> </tt>
<tt class="py-lineno"> 87</tt>  <tt class="py-line">        <tt class="py-name">response</tt> <tt class="py-op">=</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-12" class="py-name" targets="Method s3.objects.S3Bucket._request()=s3.objects.S3Bucket-class.html#_request"><a title="s3.objects.S3Bucket._request" class="py-name" href="#" onclick="return doclink('link-12', '_request', 'link-12');">_request</a></tt></tt><tt class="py-op">(</tt><tt class="py-string">'GET'</tt><tt class="py-op">,</tt> <tt class="py-name">key</tt><tt class="py-op">,</tt> <tt class="py-name">headers</tt><tt class="py-op">=</tt><tt class="py-name">headers</tt><tt class="py-op">)</tt> </tt>
<tt class="py-lineno"> 88</tt>  <tt class="py-line">        <tt class="py-name">headers</tt> <tt class="py-op">=</tt> <tt class="py-name">response</tt><tt class="py-op">.</tt><tt class="py-name">getheaders</tt><tt class="py-op">(</tt><tt class="py-op">)</tt> </tt>
<tt class="py-lineno"> 89</tt>  <tt class="py-line">        <tt class="py-name">data</tt> <tt class="py-op">=</tt> <tt class="py-name">response</tt><tt class="py-op">.</tt><tt class="py-name">read</tt><tt class="py-op">(</tt><tt class="py-op">)</tt> </tt>
<tt class="py-lineno"> 90</tt>  <tt class="py-line">        <tt class="py-name">metadata</tt> <tt class="py-op">=</tt> <tt class="py-op">{</tt><tt class="py-op">}</tt> </tt>
<tt class="py-lineno"> 91</tt>  <tt class="py-line">        <tt class="py-name">last_modified</tt> <tt class="py-op">=</tt> <tt class="py-string">''</tt> </tt>
<tt class="py-lineno"> 92</tt>  <tt class="py-line">        <tt class="py-keyword">for</tt> <tt class="py-name">header</tt> <tt class="py-keyword">in</tt> <tt class="py-name">headers</tt><tt class="py-op">:</tt> </tt>
<tt class="py-lineno"> 93</tt>  <tt class="py-line">            <tt class="py-keyword">if</tt> <tt class="py-name">header</tt><tt class="py-op">[</tt><tt class="py-number">0</tt><tt class="py-op">]</tt><tt class="py-op">.</tt><tt class="py-name">startswith</tt><tt class="py-op">(</tt><tt class="py-string">'x-amz-meta-'</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
<tt class="py-lineno"> 94</tt>  <tt class="py-line">                <tt class="py-name">metadata</tt><tt class="py-op">[</tt><tt class="py-name">header</tt><tt class="py-op">[</tt><tt class="py-number">0</tt><tt class="py-op">]</tt><tt class="py-op">[</tt><tt class="py-number">11</tt><tt class="py-op">:</tt><tt class="py-op">]</tt><tt class="py-op">]</tt> <tt class="py-op">=</tt> <tt class="py-name">header</tt><tt class="py-op">[</tt><tt class="py-number">1</tt><tt class="py-op">]</tt> </tt>
<tt class="py-lineno"> 95</tt>  <tt class="py-line">            <tt class="py-keyword">elif</tt> <tt class="py-name">header</tt><tt class="py-op">[</tt><tt class="py-number">0</tt><tt class="py-op">]</tt> <tt class="py-op">==</tt> <tt class="py-string">'Last-Modified'</tt><tt class="py-op">:</tt> </tt>
<tt class="py-lineno"> 96</tt>  <tt class="py-line">                <tt class="py-name">last_modified</tt> <tt class="py-op">=</tt> <tt class="py-name">header</tt><tt class="py-op">[</tt><tt class="py-number">1</tt><tt class="py-op">]</tt> </tt>
<tt class="py-lineno"> 97</tt>  <tt class="py-line">        <tt class="py-keyword">return</tt> <tt id="link-13" class="py-name" targets="Class s3.objects.S3Object=s3.objects.S3Object-class.html"><a title="s3.objects.S3Object" class="py-name" href="#" onclick="return doclink('link-13', 'S3Object', 'link-13');">S3Object</a></tt></tt><tt class="py-op">(</tt><tt class="py-name">key</tt><tt class="py-op">,</tt> <tt class="py-name">data</tt><tt class="py-op">,</tt> <tt class="py-name">metadata</tt><tt class="py-op">,</tt> <tt class="py-name">last_modified</tt><tt class="py-op">,</tt> <tt class="py-name">self</tt><tt class="py-op">)</tt> </tt>
</div><tt class="py-lineno"> 98</tt>  <tt class="py-line"> </tt>
<tt class="py-lineno"> 99</tt>  <tt class="py-line"> </tt>
<a name="S3Bucket.head"></a><div id="S3Bucket.head-def"><tt class="py-lineno">100</tt> <a class="py-toggle" href="#" id="S3Bucket.head-toggle" onclick="return toggle('S3Bucket.head');">-</a><tt class="py-line">    <tt class="py-keyword">def</tt> <a class="py-def-name" href="s3.objects.S3Bucket-class.html#head">head</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">key</tt><tt class="py-op">,</tt> <tt class="py-param">headers</tt><tt class="py-op">=</tt><tt class="py-op">{</tt><tt class="py-op">}</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
</div><div id="S3Bucket.head-collapsed" style="display:none;" pad="+++" indent="++++++++"></div><div id="S3Bucket.head-expanded"><tt class="py-lineno">101</tt>  <tt class="py-line">        <tt class="py-docstring">"""</tt> </tt>
<tt class="py-lineno">102</tt>  <tt class="py-line"><tt class="py-docstring">        Get an object's headers from bucket.</tt> </tt>
<tt class="py-lineno">103</tt>  <tt class="py-line"><tt class="py-docstring"></tt> </tt>
<tt class="py-lineno">104</tt>  <tt class="py-line"><tt class="py-docstring">        @param key:     Key of the object</tt> </tt>
<tt class="py-lineno">105</tt>  <tt class="py-line"><tt class="py-docstring">        @type  key:     string</tt> </tt>
<tt class="py-lineno">106</tt>  <tt class="py-line"><tt class="py-docstring">        @param headers: Dictionary of additional headers</tt> </tt>
<tt class="py-lineno">107</tt>  <tt class="py-line"><tt class="py-docstring">        @type  headers: dict</tt> </tt>
<tt class="py-lineno">108</tt>  <tt class="py-line"><tt class="py-docstring">        @return:        Dictionary of object headers</tt> </tt>
<tt class="py-lineno">109</tt>  <tt class="py-line"><tt class="py-docstring">        @rtype:         dict</tt> </tt>
<tt class="py-lineno">110</tt>  <tt class="py-line"><tt class="py-docstring">        """</tt> </tt>
<tt class="py-lineno">111</tt>  <tt class="py-line">        <tt class="py-keyword">return</tt> <tt class="py-name">dict</tt><tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-14" class="py-name"><a title="s3.objects.S3Bucket._request" class="py-name" href="#" onclick="return doclink('link-14', '_request', 'link-12');">_request</a></tt></tt><tt class="py-op">(</tt><tt class="py-string">'HEAD'</tt><tt class="py-op">,</tt> <tt class="py-name">key</tt><tt class="py-op">,</tt> <tt class="py-name">headers</tt><tt class="py-op">=</tt><tt class="py-name">headers</tt><tt class="py-op">)</tt><tt class="py-op">.</tt><tt class="py-name">getheaders</tt><tt class="py-op">(</tt><tt class="py-op">)</tt><tt class="py-op">)</tt> </tt>
</div><tt class="py-lineno">112</tt>  <tt class="py-line"> </tt>
<tt class="py-lineno">113</tt>  <tt class="py-line"> </tt>
<a name="S3Bucket.list"></a><div id="S3Bucket.list-def"><tt class="py-lineno">114</tt> <a class="py-toggle" href="#" id="S3Bucket.list-toggle" onclick="return toggle('S3Bucket.list');">-</a><tt class="py-line">    <tt class="py-keyword">def</tt> <a class="py-def-name" href="s3.objects.S3Bucket-class.html#list">list</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">prefix</tt><tt class="py-op">=</tt><tt class="py-name">None</tt><tt class="py-op">,</tt> <tt class="py-param">marker</tt><tt class="py-op">=</tt><tt class="py-name">None</tt><tt class="py-op">,</tt> <tt class="py-param">max_keys</tt><tt class="py-op">=</tt><tt class="py-name">None</tt><tt class="py-op">,</tt> <tt class="py-param">delimiter</tt><tt class="py-op">=</tt><tt class="py-name">None</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
</div><div id="S3Bucket.list-collapsed" style="display:none;" pad="+++" indent="++++++++"></div><div id="S3Bucket.list-expanded"><tt class="py-lineno">115</tt>  <tt class="py-line">        <tt class="py-docstring">"""</tt> </tt>
<tt class="py-lineno">116</tt>  <tt class="py-line"><tt class="py-docstring">        List bucket objects.</tt> </tt>
<tt class="py-lineno">117</tt>  <tt class="py-line"><tt class="py-docstring">        </tt> </tt>
<tt class="py-lineno">118</tt>  <tt class="py-line"><tt class="py-docstring">        @param prefix:    Limits the response to keys which begin with the</tt> </tt>
<tt class="py-lineno">119</tt>  <tt class="py-line"><tt class="py-docstring">                          indicated prefix. You can use prefixes to separate a</tt> </tt>
<tt class="py-lineno">120</tt>  <tt class="py-line"><tt class="py-docstring">                          bucket into different sets of keys in a way similar to</tt> </tt>
<tt class="py-lineno">121</tt>  <tt class="py-line"><tt class="py-docstring">                          how a file system uses folders.</tt> </tt>
<tt class="py-lineno">122</tt>  <tt class="py-line"><tt class="py-docstring">        @type  prefix:    string</tt> </tt>
<tt class="py-lineno">123</tt>  <tt class="py-line"><tt class="py-docstring">        @param marker:    Indicates where in the bucket to begin listing.</tt> </tt>
<tt class="py-lineno">124</tt>  <tt class="py-line"><tt class="py-docstring">                          The list will only include keys that occur</tt> </tt>
<tt class="py-lineno">125</tt>  <tt class="py-line"><tt class="py-docstring">                          lexicographically after marker. This is convenient for</tt> </tt>
<tt class="py-lineno">126</tt>  <tt class="py-line"><tt class="py-docstring">                          pagination: To get the next page of results use the</tt> </tt>
<tt class="py-lineno">127</tt>  <tt class="py-line"><tt class="py-docstring">                          last key of the current page as the marker.</tt> </tt>
<tt class="py-lineno">128</tt>  <tt class="py-line"><tt class="py-docstring">        @type  marker:    string</tt> </tt>
<tt class="py-lineno">129</tt>  <tt class="py-line"><tt class="py-docstring">        @param max_keys:  The maximum number of keys you'd like to see in the</tt> </tt>
<tt class="py-lineno">130</tt>  <tt class="py-line"><tt class="py-docstring">                          response body. The server may return fewer than this</tt> </tt>
<tt class="py-lineno">131</tt>  <tt class="py-line"><tt class="py-docstring">                          many keys, but will not return more.</tt> </tt>
<tt class="py-lineno">132</tt>  <tt class="py-line"><tt class="py-docstring">        @type  max_keys:  int</tt> </tt>
<tt class="py-lineno">133</tt>  <tt class="py-line"><tt class="py-docstring">        @param delimiter: Causes keys that contain the same string between the</tt> </tt>
<tt class="py-lineno">134</tt>  <tt class="py-line"><tt class="py-docstring">                          prefix and the first occurrence of the delimiter to be</tt> </tt>
<tt class="py-lineno">135</tt>  <tt class="py-line"><tt class="py-docstring">                          rolled up into a single result element in the</tt> </tt>
<tt class="py-lineno">136</tt>  <tt class="py-line"><tt class="py-docstring">                          CommonPrefixes collection. These rolled-up keys are</tt> </tt>
<tt class="py-lineno">137</tt>  <tt class="py-line"><tt class="py-docstring">                          not returned elsewhere in the response.</tt> </tt>
<tt class="py-lineno">138</tt>  <tt class="py-line"><tt class="py-docstring">        @type  delimiter: char</tt> </tt>
<tt class="py-lineno">139</tt>  <tt class="py-line"><tt class="py-docstring">        """</tt> </tt>
<tt class="py-lineno">140</tt>  <tt class="py-line">        <tt id="link-15" class="py-name" targets="Method s3.objects.S3Bucket.keys()=s3.objects.S3Bucket-class.html#keys,Method s3.service.S3Service.keys()=s3.service.S3Service-class.html#keys"><a title="s3.objects.S3Bucket.keys
s3.service.S3Service.keys" class="py-name" href="#" onclick="return doclink('link-15', 'keys', 'link-15');">keys</a></tt></tt> <tt class="py-op">=</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-16" class="py-name"><a title="s3.objects.S3Bucket.keys
s3.service.S3Service.keys" class="py-name" href="#" onclick="return doclink('link-16', 'keys', 'link-15');">keys</a></tt></tt><tt class="py-op">(</tt><tt class="py-name">prefix</tt><tt class="py-op">=</tt><tt class="py-name">prefix</tt><tt class="py-op">,</tt> <tt class="py-name">marker</tt><tt class="py-op">=</tt><tt class="py-name">marker</tt><tt class="py-op">,</tt> <tt class="py-name">max_keys</tt><tt class="py-op">=</tt><tt class="py-name">max_keys</tt><tt class="py-op">,</tt> <tt class="py-name">delimiter</tt><tt class="py-op">=</tt><tt class="py-name">delimiter</tt><tt class="py-op">)</tt> </tt>
<tt class="py-lineno">141</tt>  <tt class="py-line">        <tt id="link-17" class="py-name" targets="Module s3.objects=s3.objects-module.html"><a title="s3.objects" class="py-name" href="#" onclick="return doclink('link-17', 'objects', 'link-17');">objects</a></tt></tt> <tt class="py-op">=</tt> <tt class="py-op">[</tt><tt class="py-op">]</tt> </tt>
<tt class="py-lineno">142</tt>  <tt class="py-line">        <tt class="py-keyword">for</tt> <tt class="py-name">key</tt> <tt class="py-keyword">in</tt> <tt id="link-18" class="py-name"><a title="s3.objects.S3Bucket.keys
s3.service.S3Service.keys" class="py-name" href="#" onclick="return doclink('link-18', 'keys', 'link-15');">keys</a></tt></tt><tt class="py-op">:</tt> </tt>
<tt class="py-lineno">143</tt>  <tt class="py-line">            <tt id="link-19" class="py-name"><a title="s3.objects" class="py-name" href="#" onclick="return doclink('link-19', 'objects', 'link-17');">objects</a></tt></tt><tt class="py-op">.</tt><tt class="py-name">append</tt><tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-20" class="py-name" targets="Method s3.generator.S3Generator.get()=s3.generator.S3Generator-class.html#get,Method s3.objects.S3Bucket.get()=s3.objects.S3Bucket-class.html#get,Method s3.service.S3Service.get()=s3.service.S3Service-class.html#get"><a title="s3.generator.S3Generator.get
s3.objects.S3Bucket.get
s3.service.S3Service.get" class="py-name" href="#" onclick="return doclink('link-20', 'get', 'link-20');">get</a></tt></tt><tt class="py-op">(</tt><tt class="py-name">key</tt><tt class="py-op">)</tt><tt class="py-op">)</tt> </tt>
<tt class="py-lineno">144</tt>  <tt class="py-line">        <tt class="py-keyword">return</tt> <tt id="link-21" class="py-name"><a title="s3.objects" class="py-name" href="#" onclick="return doclink('link-21', 'objects', 'link-17');">objects</a></tt></tt> </tt>
</div><tt class="py-lineno">145</tt>  <tt class="py-line"> </tt>
<tt class="py-lineno">146</tt>  <tt class="py-line"> </tt>
<a name="S3Bucket.save"></a><div id="S3Bucket.save-def"><tt class="py-lineno">147</tt> <a class="py-toggle" href="#" id="S3Bucket.save-toggle" onclick="return toggle('S3Bucket.save');">-</a><tt class="py-line">    <tt class="py-keyword">def</tt> <a class="py-def-name" href="s3.objects.S3Bucket-class.html#save">save</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">s3object</tt><tt class="py-op">,</tt> <tt class="py-param">headers</tt><tt class="py-op">=</tt><tt class="py-op">{</tt><tt class="py-op">}</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
</div><div id="S3Bucket.save-collapsed" style="display:none;" pad="+++" indent="++++++++"></div><div id="S3Bucket.save-expanded"><tt class="py-lineno">148</tt>  <tt class="py-line">        <tt class="py-docstring">"""</tt> </tt>
<tt class="py-lineno">149</tt>  <tt class="py-line"><tt class="py-docstring">        Save an S3Object into bucket.</tt> </tt>
<tt class="py-lineno">150</tt>  <tt class="py-line"><tt class="py-docstring">        </tt> </tt>
<tt class="py-lineno">151</tt>  <tt class="py-line"><tt class="py-docstring">        @param s3object: An S3Object that has to be saved</tt> </tt>
<tt class="py-lineno">152</tt>  <tt class="py-line"><tt class="py-docstring">        @type  s3object: S3Object</tt> </tt>
<tt class="py-lineno">153</tt>  <tt class="py-line"><tt class="py-docstring">        @param headers:  Dictionary of additional headers</tt> </tt>
<tt class="py-lineno">154</tt>  <tt class="py-line"><tt class="py-docstring">        @type  headers:  dict</tt> </tt>
<tt class="py-lineno">155</tt>  <tt class="py-line"><tt class="py-docstring">        """</tt> </tt>
<tt class="py-lineno">156</tt>  <tt class="py-line">        <tt class="py-name">data</tt> <tt class="py-op">=</tt> <tt class="py-name">s3object</tt><tt class="py-op">.</tt><tt class="py-name">data</tt> </tt>
<tt class="py-lineno">157</tt>  <tt class="py-line">        <tt class="py-keyword">if</tt> <tt class="py-name">isinstance</tt><tt class="py-op">(</tt><tt class="py-name">data</tt><tt class="py-op">,</tt> <tt class="py-name">str</tt><tt class="py-op">)</tt> <tt class="py-keyword">or</tt> <tt class="py-name">isinstance</tt><tt class="py-op">(</tt><tt class="py-name">data</tt><tt class="py-op">,</tt> <tt class="py-name">unicode</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
<tt class="py-lineno">158</tt>  <tt class="py-line">            <tt class="py-name">data</tt> <tt class="py-op">=</tt> <tt class="py-name">StringIO</tt><tt class="py-op">(</tt><tt class="py-name">data</tt><tt class="py-op">)</tt> </tt>
<tt class="py-lineno">159</tt>  <tt class="py-line">        <tt class="py-keyword">for</tt> <tt class="py-name">key</tt> <tt class="py-keyword">in</tt> <tt class="py-name">s3object</tt><tt class="py-op">.</tt><tt class="py-name">metadata</tt><tt class="py-op">:</tt> </tt>
<tt class="py-lineno">160</tt>  <tt class="py-line">            <tt class="py-name">headers</tt><tt class="py-op">[</tt><tt class="py-string">'x-amz-meta-'</tt> <tt class="py-op">+</tt> <tt class="py-name">key</tt><tt class="py-op">]</tt> <tt class="py-op">=</tt> <tt class="py-name">s3object</tt><tt class="py-op">.</tt><tt class="py-name">metadata</tt><tt class="py-op">[</tt><tt class="py-name">key</tt><tt class="py-op">]</tt> </tt>
<tt class="py-lineno">161</tt>  <tt class="py-line">        <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-22" class="py-name"><a title="s3.objects.S3Bucket._request" class="py-name" href="#" onclick="return doclink('link-22', '_request', 'link-12');">_request</a></tt></tt><tt class="py-op">(</tt><tt class="py-string">'PUT'</tt><tt class="py-op">,</tt> <tt class="py-name">s3object</tt><tt class="py-op">.</tt><tt class="py-name">key</tt><tt class="py-op">,</tt> <tt class="py-name">send_io</tt><tt class="py-op">=</tt><tt class="py-name">data</tt><tt class="py-op">,</tt> <tt class="py-name">headers</tt><tt class="py-op">=</tt><tt class="py-name">headers</tt><tt class="py-op">)</tt> </tt>
</div><tt class="py-lineno">162</tt>  <tt class="py-line"> </tt>
<tt class="py-lineno">163</tt>  <tt class="py-line"> </tt>
<a name="S3Bucket.delete"></a><div id="S3Bucket.delete-def"><tt class="py-lineno">164</tt> <a class="py-toggle" href="#" id="S3Bucket.delete-toggle" onclick="return toggle('S3Bucket.delete');">-</a><tt class="py-line">    <tt class="py-keyword">def</tt> <a class="py-def-name" href="s3.objects.S3Bucket-class.html#delete">delete</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">objects</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
</div><div id="S3Bucket.delete-collapsed" style="display:none;" pad="+++" indent="++++++++"></div><div id="S3Bucket.delete-expanded"><tt class="py-lineno">165</tt>  <tt class="py-line">        <tt class="py-docstring">"""</tt> </tt>
<tt class="py-lineno">166</tt>  <tt class="py-line"><tt class="py-docstring">        Delete an S3Object, a key or list of keys or objects from bucket.</tt> </tt>
<tt class="py-lineno">167</tt>  <tt class="py-line"><tt class="py-docstring">        </tt> </tt>
<tt class="py-lineno">168</tt>  <tt class="py-line"><tt class="py-docstring">        @param objects: S3Object, S3Object key, or list of both to be deleted</tt> </tt>
<tt class="py-lineno">169</tt>  <tt class="py-line"><tt class="py-docstring">        @type  objects: S3Object, string, list of S3Objects or list of strings</tt> </tt>
<tt class="py-lineno">170</tt>  <tt class="py-line"><tt class="py-docstring">        """</tt> </tt>
<tt class="py-lineno">171</tt>  <tt class="py-line">        <tt class="py-keyword">if</tt> <tt class="py-keyword">not</tt> <tt class="py-name">isinstance</tt><tt class="py-op">(</tt><tt id="link-23" class="py-name"><a title="s3.objects" class="py-name" href="#" onclick="return doclink('link-23', 'objects', 'link-17');">objects</a></tt></tt><tt class="py-op">,</tt> <tt id="link-24" class="py-name" targets="Method s3.objects.S3Bucket.list()=s3.objects.S3Bucket-class.html#list,Method s3.service.S3Service.list()=s3.service.S3Service-class.html#list"><a title="s3.objects.S3Bucket.list
s3.service.S3Service.list" class="py-name" href="#" onclick="return doclink('link-24', 'list', 'link-24');">list</a></tt></tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
<tt class="py-lineno">172</tt>  <tt class="py-line">            <tt id="link-25" class="py-name"><a title="s3.objects" class="py-name" href="#" onclick="return doclink('link-25', 'objects', 'link-17');">objects</a></tt></tt> <tt class="py-op">=</tt> <tt class="py-op">[</tt><tt id="link-26" class="py-name"><a title="s3.objects" class="py-name" href="#" onclick="return doclink('link-26', 'objects', 'link-17');">objects</a></tt></tt><tt class="py-op">,</tt><tt class="py-op">]</tt> </tt>
<tt class="py-lineno">173</tt>  <tt class="py-line">        <tt class="py-keyword">for</tt> <tt class="py-name">obj</tt> <tt class="py-keyword">in</tt> <tt id="link-27" class="py-name"><a title="s3.objects" class="py-name" href="#" onclick="return doclink('link-27', 'objects', 'link-17');">objects</a></tt></tt><tt class="py-op">:</tt> </tt>
<tt class="py-lineno">174</tt>  <tt class="py-line">            <tt class="py-keyword">if</tt> <tt class="py-name">isinstance</tt><tt class="py-op">(</tt><tt class="py-name">obj</tt><tt class="py-op">,</tt> <tt id="link-28" class="py-name"><a title="s3.objects.S3Object" class="py-name" href="#" onclick="return doclink('link-28', 'S3Object', 'link-13');">S3Object</a></tt></tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
<tt class="py-lineno">175</tt>  <tt class="py-line">                <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-29" class="py-name"><a title="s3.objects.S3Bucket._request" class="py-name" href="#" onclick="return doclink('link-29', '_request', 'link-12');">_request</a></tt></tt><tt class="py-op">(</tt><tt class="py-string">'DELETE'</tt><tt class="py-op">,</tt> <tt class="py-name">obj</tt><tt class="py-op">.</tt><tt class="py-name">key</tt><tt class="py-op">)</tt> </tt>
<tt class="py-lineno">176</tt>  <tt class="py-line">            <tt class="py-keyword">else</tt><tt class="py-op">:</tt> </tt>
<tt class="py-lineno">177</tt>  <tt class="py-line">                <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-30" class="py-name"><a title="s3.objects.S3Bucket._request" class="py-name" href="#" onclick="return doclink('link-30', '_request', 'link-12');">_request</a></tt></tt><tt class="py-op">(</tt><tt class="py-string">'DELETE'</tt><tt class="py-op">,</tt> <tt class="py-name">obj</tt><tt class="py-op">)</tt> </tt>
</div><tt class="py-lineno">178</tt>  <tt class="py-line"> </tt>
<tt class="py-lineno">179</tt>  <tt class="py-line"> </tt>
<a name="S3Bucket.keys"></a><div id="S3Bucket.keys-def"><tt class="py-lineno">180</tt> <a class="py-toggle" href="#" id="S3Bucket.keys-toggle" onclick="return toggle('S3Bucket.keys');">-</a><tt class="py-line">    <tt class="py-keyword">def</tt> <a class="py-def-name" href="s3.objects.S3Bucket-class.html#keys">keys</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">prefix</tt><tt class="py-op">=</tt><tt class="py-name">None</tt><tt class="py-op">,</tt> <tt class="py-param">marker</tt><tt class="py-op">=</tt><tt class="py-name">None</tt><tt class="py-op">,</tt> <tt class="py-param">max_keys</tt><tt class="py-op">=</tt><tt class="py-name">None</tt><tt class="py-op">,</tt> <tt class="py-param">delimiter</tt><tt class="py-op">=</tt><tt class="py-name">None</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
</div><div id="S3Bucket.keys-collapsed" style="display:none;" pad="+++" indent="++++++++"></div><div id="S3Bucket.keys-expanded"><tt class="py-lineno">181</tt>  <tt class="py-line">        <tt class="py-docstring">"""</tt> </tt>
<tt class="py-lineno">182</tt>  <tt class="py-line"><tt class="py-docstring">        Returns a flat list of object keys in bucket.</tt> </tt>
<tt class="py-lineno">183</tt>  <tt class="py-line"><tt class="py-docstring">        </tt> </tt>
<tt class="py-lineno">184</tt>  <tt class="py-line"><tt class="py-docstring">        @param prefix:    Limits the response to keys which begin with the</tt> </tt>
<tt class="py-lineno">185</tt>  <tt class="py-line"><tt class="py-docstring">                          indicated prefix. You can use prefixes to separate a</tt> </tt>
<tt class="py-lineno">186</tt>  <tt class="py-line"><tt class="py-docstring">                          bucket into different sets of keys in a way similar to</tt> </tt>
<tt class="py-lineno">187</tt>  <tt class="py-line"><tt class="py-docstring">                          how a file system uses folders.</tt> </tt>
<tt class="py-lineno">188</tt>  <tt class="py-line"><tt class="py-docstring">        @type  prefix:    string</tt> </tt>
<tt class="py-lineno">189</tt>  <tt class="py-line"><tt class="py-docstring">        @param marker:    Indicates where in the bucket to begin listing.</tt> </tt>
<tt class="py-lineno">190</tt>  <tt class="py-line"><tt class="py-docstring">                          The list will only include keys that occur</tt> </tt>
<tt class="py-lineno">191</tt>  <tt class="py-line"><tt class="py-docstring">                          lexicographically after marker. This is convenient for</tt> </tt>
<tt class="py-lineno">192</tt>  <tt class="py-line"><tt class="py-docstring">                          pagination: To get the next page of results use the</tt> </tt>
<tt class="py-lineno">193</tt>  <tt class="py-line"><tt class="py-docstring">                          last key of the current page as the marker.</tt> </tt>
<tt class="py-lineno">194</tt>  <tt class="py-line"><tt class="py-docstring">        @type  marker:    string</tt> </tt>
<tt class="py-lineno">195</tt>  <tt class="py-line"><tt class="py-docstring">        @param max_keys:  The maximum number of keys you'd like to see in the</tt> </tt>
<tt class="py-lineno">196</tt>  <tt class="py-line"><tt class="py-docstring">                          response body. The server may return fewer than this</tt> </tt>
<tt class="py-lineno">197</tt>  <tt class="py-line"><tt class="py-docstring">                          many keys, but will not return more.</tt> </tt>
<tt class="py-lineno">198</tt>  <tt class="py-line"><tt class="py-docstring">        @type  max_keys:  int</tt> </tt>
<tt class="py-lineno">199</tt>  <tt class="py-line"><tt class="py-docstring">        @param delimiter: Causes keys that contain the same string between the</tt> </tt>
<tt class="py-lineno">200</tt>  <tt class="py-line"><tt class="py-docstring">                          prefix and the first occurrence of the delimiter to be</tt> </tt>
<tt class="py-lineno">201</tt>  <tt class="py-line"><tt class="py-docstring">                          rolled up into a single result element in the</tt> </tt>
<tt class="py-lineno">202</tt>  <tt class="py-line"><tt class="py-docstring">                          CommonPrefixes collection. These rolled-up keys are</tt> </tt>
<tt class="py-lineno">203</tt>  <tt class="py-line"><tt class="py-docstring">                          not returned elsewhere in the response.</tt> </tt>
<tt class="py-lineno">204</tt>  <tt class="py-line"><tt class="py-docstring">        @type  delimiter: char</tt> </tt>
<tt class="py-lineno">205</tt>  <tt class="py-line"><tt class="py-docstring">        """</tt> </tt>
<tt class="py-lineno">206</tt>  <tt class="py-line">        <tt class="py-name">params</tt> <tt class="py-op">=</tt> <tt class="py-op">{</tt><tt class="py-op">}</tt> </tt>
<tt class="py-lineno">207</tt>  <tt class="py-line">        <tt class="py-keyword">if</tt> <tt class="py-name">prefix</tt><tt class="py-op">:</tt> <tt class="py-name">params</tt><tt class="py-op">[</tt><tt class="py-string">'prefix'</tt><tt class="py-op">]</tt> <tt class="py-op">=</tt> <tt class="py-name">prefix</tt> </tt>
<tt class="py-lineno">208</tt>  <tt class="py-line">        <tt class="py-keyword">if</tt> <tt class="py-name">marker</tt><tt class="py-op">:</tt> <tt class="py-name">params</tt><tt class="py-op">[</tt><tt class="py-string">'marker'</tt><tt class="py-op">]</tt> <tt class="py-op">=</tt> <tt class="py-name">marker</tt> </tt>
<tt class="py-lineno">209</tt>  <tt class="py-line">        <tt class="py-keyword">if</tt> <tt class="py-name">max_keys</tt><tt class="py-op">:</tt> <tt class="py-name">params</tt><tt class="py-op">[</tt><tt class="py-string">'max-keys'</tt><tt class="py-op">]</tt> <tt class="py-op">=</tt> <tt class="py-name">max_keys</tt> </tt>
<tt class="py-lineno">210</tt>  <tt class="py-line">        <tt class="py-keyword">if</tt> <tt class="py-name">delimiter</tt><tt class="py-op">:</tt> <tt class="py-name">params</tt><tt class="py-op">[</tt><tt class="py-string">'delimiter'</tt><tt class="py-op">]</tt> <tt class="py-op">=</tt> <tt class="py-name">delimiter</tt> </tt>
<tt class="py-lineno">211</tt>  <tt class="py-line">         </tt>
<tt class="py-lineno">212</tt>  <tt class="py-line">        <tt class="py-name">response</tt> <tt class="py-op">=</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-31" class="py-name"><a title="s3.objects.S3Bucket._request" class="py-name" href="#" onclick="return doclink('link-31', '_request', 'link-12');">_request</a></tt></tt><tt class="py-op">(</tt><tt class="py-string">'GET'</tt><tt class="py-op">,</tt> <tt class="py-name">params</tt><tt class="py-op">=</tt><tt class="py-name">params</tt><tt class="py-op">)</tt> </tt>
<tt class="py-lineno">213</tt>  <tt class="py-line">        <tt class="py-keyword">return</tt> <tt id="link-32" class="py-name"><a title="s3.parsers.parseListKeys" class="py-name" href="#" onclick="return doclink('link-32', 'parseListKeys', 'link-5');">parseListKeys</a></tt></tt><tt class="py-op">(</tt><tt class="py-name">response</tt><tt class="py-op">.</tt><tt class="py-name">read</tt><tt class="py-op">(</tt><tt class="py-op">)</tt><tt class="py-op">)</tt> </tt>
</div><tt class="py-lineno">214</tt>  <tt class="py-line"> </tt>
<tt class="py-lineno">215</tt>  <tt class="py-line">    <tt class="py-name">values</tt> <tt class="py-op">=</tt> <tt id="link-33" class="py-name"><a title="s3.objects.S3Bucket.list
s3.service.S3Service.list" class="py-name" href="#" onclick="return doclink('link-33', 'list', 'link-24');">list</a></tt></tt> </tt>
<tt class="py-lineno">216</tt>  <tt class="py-line"> </tt>
<a name="S3Bucket.items"></a><div id="S3Bucket.items-def"><tt class="py-lineno">217</tt> <a class="py-toggle" href="#" id="S3Bucket.items-toggle" onclick="return toggle('S3Bucket.items');">-</a><tt class="py-line">    <tt class="py-keyword">def</tt> <a class="py-def-name" href="s3.objects.S3Bucket-class.html#items">items</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
</div><div id="S3Bucket.items-collapsed" style="display:none;" pad="+++" indent="++++++++"></div><div id="S3Bucket.items-expanded"><tt class="py-lineno">218</tt>  <tt class="py-line">        <tt class="py-docstring">"""</tt> </tt>
<tt class="py-lineno">219</tt>  <tt class="py-line"><tt class="py-docstring">        Returns (key, value) pairs, where, keys are object names, and values are S3Objects.</tt> </tt>
<tt class="py-lineno">220</tt>  <tt class="py-line"><tt class="py-docstring">        </tt> </tt>
<tt class="py-lineno">221</tt>  <tt class="py-line"><tt class="py-docstring">        @return: List of (bucket name, bucket) pairs</tt> </tt>
<tt class="py-lineno">222</tt>  <tt class="py-line"><tt class="py-docstring">        @rtype:  list</tt> </tt>
<tt class="py-lineno">223</tt>  <tt class="py-line"><tt class="py-docstring">        """</tt> </tt>
<tt class="py-lineno">224</tt>  <tt class="py-line">        <tt class="py-keyword">return</tt> <tt class="py-name">zip</tt><tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-34" class="py-name"><a title="s3.objects.S3Bucket.keys
s3.service.S3Service.keys" class="py-name" href="#" onclick="return doclink('link-34', 'keys', 'link-15');">keys</a></tt></tt><tt class="py-op">(</tt><tt class="py-op">)</tt><tt class="py-op">,</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-35" class="py-name"><a title="s3.objects.S3Bucket.list
s3.service.S3Service.list" class="py-name" href="#" onclick="return doclink('link-35', 'list', 'link-24');">list</a></tt></tt><tt class="py-op">(</tt><tt class="py-op">)</tt><tt class="py-op">)</tt> </tt>
</div><tt class="py-lineno">225</tt>  <tt class="py-line"> </tt>
<a name="S3Bucket.has_key"></a><div id="S3Bucket.has_key-def"><tt class="py-lineno">226</tt> <a class="py-toggle" href="#" id="S3Bucket.has_key-toggle" onclick="return toggle('S3Bucket.has_key');">-</a><tt class="py-line">    <tt class="py-keyword">def</tt> <a class="py-def-name" href="s3.objects.S3Bucket-class.html#has_key">has_key</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">key</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
</div><div id="S3Bucket.has_key-collapsed" style="display:none;" pad="+++" indent="++++++++"></div><div id="S3Bucket.has_key-expanded"><tt class="py-lineno">227</tt>  <tt class="py-line">        <tt class="py-docstring">"""</tt> </tt>
<tt class="py-lineno">228</tt>  <tt class="py-line"><tt class="py-docstring">        Does key exists in bucket.</tt> </tt>
<tt class="py-lineno">229</tt>  <tt class="py-line"><tt class="py-docstring">        """</tt> </tt>
<tt class="py-lineno">230</tt>  <tt class="py-line">        <tt class="py-keyword">return</tt> <tt class="py-name">key</tt> <tt class="py-keyword">in</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-36" class="py-name"><a title="s3.objects.S3Bucket.keys
s3.service.S3Service.keys" class="py-name" href="#" onclick="return doclink('link-36', 'keys', 'link-15');">keys</a></tt></tt><tt class="py-op">(</tt><tt class="py-name">prefix</tt><tt class="py-op">=</tt><tt class="py-name">key</tt><tt class="py-op">)</tt> </tt>
</div><tt class="py-lineno">231</tt>  <tt class="py-line"> </tt>
<tt class="py-lineno">232</tt>  <tt class="py-line"> </tt>
<a name="S3Bucket.__getitem__"></a><div id="S3Bucket.__getitem__-def"><tt class="py-lineno">233</tt> <a class="py-toggle" href="#" id="S3Bucket.__getitem__-toggle" onclick="return toggle('S3Bucket.__getitem__');">-</a><tt class="py-line">    <tt class="py-keyword">def</tt> <a class="py-def-name" href="s3.objects.S3Bucket-class.html#__getitem__">__getitem__</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">key</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
</div><div id="S3Bucket.__getitem__-collapsed" style="display:none;" pad="+++" indent="++++++++"></div><div id="S3Bucket.__getitem__-expanded"><tt class="py-lineno">234</tt>  <tt class="py-line">        <tt class="py-docstring">"""</tt> </tt>
<tt class="py-lineno">235</tt>  <tt class="py-line"><tt class="py-docstring">        Get an S3Object from bucket.</tt> </tt>
<tt class="py-lineno">236</tt>  <tt class="py-line"><tt class="py-docstring">        """</tt> </tt>
<tt class="py-lineno">237</tt>  <tt class="py-line">        <tt class="py-keyword">return</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-37" class="py-name"><a title="s3.generator.S3Generator.get
s3.objects.S3Bucket.get
s3.service.S3Service.get" class="py-name" href="#" onclick="return doclink('link-37', 'get', 'link-20');">get</a></tt></tt><tt class="py-op">(</tt><tt class="py-name">key</tt><tt class="py-op">)</tt> </tt>
</div><tt class="py-lineno">238</tt>  <tt class="py-line"> </tt>
<tt class="py-lineno">239</tt>  <tt class="py-line"> </tt>
<a name="S3Bucket.__delitem__"></a><div id="S3Bucket.__delitem__-def"><tt class="py-lineno">240</tt> <a class="py-toggle" href="#" id="S3Bucket.__delitem__-toggle" onclick="return toggle('S3Bucket.__delitem__');">-</a><tt class="py-line">    <tt class="py-keyword">def</tt> <a class="py-def-name" href="s3.objects.S3Bucket-class.html#__delitem__">__delitem__</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">s3object</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
</div><div id="S3Bucket.__delitem__-collapsed" style="display:none;" pad="+++" indent="++++++++"></div><div id="S3Bucket.__delitem__-expanded"><tt class="py-lineno">241</tt>  <tt class="py-line">        <tt class="py-docstring">"""</tt> </tt>
<tt class="py-lineno">242</tt>  <tt class="py-line"><tt class="py-docstring">        Delete a key from bucket.</tt> </tt>
<tt class="py-lineno">243</tt>  <tt class="py-line"><tt class="py-docstring">        """</tt> </tt>
<tt class="py-lineno">244</tt>  <tt class="py-line">        <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-38" class="py-name"><a title="s3.generator.S3Generator.delete
s3.objects.S3Bucket.delete
s3.objects.S3Object.delete
s3.service.S3Service.delete" class="py-name" href="#" onclick="return doclink('link-38', 'delete', 'link-8');">delete</a></tt></tt><tt class="py-op">(</tt><tt class="py-name">s3object</tt><tt class="py-op">)</tt> </tt>
</div></div><tt class="py-lineno">245</tt>  <tt class="py-line"> </tt><script type="text/javascript">
<!--
expandto(location.href);
// -->
</script>
</pre>
<br />
<!-- ==================== NAVIGATION BAR ==================== -->
<table class="navbar" border="0" width="100%" cellpadding="0"
       bgcolor="#a0c0ff" cellspacing="0">
  <tr valign="middle">
  <!-- Home link -->
      <th>&nbsp;&nbsp;&nbsp;<a
        href="s3-module.html">Home</a>&nbsp;&nbsp;&nbsp;</th>

  <!-- Tree link -->
      <th>&nbsp;&nbsp;&nbsp;<a
        href="module-tree.html">Trees</a>&nbsp;&nbsp;&nbsp;</th>

  <!-- Index link -->
      <th>&nbsp;&nbsp;&nbsp;<a
        href="identifier-index.html">Indices</a>&nbsp;&nbsp;&nbsp;</th>

  <!-- Help link -->
      <th>&nbsp;&nbsp;&nbsp;<a
        href="help.html">Help</a>&nbsp;&nbsp;&nbsp;</th>

      <th class="navbar" width="100%"></th>
  </tr>
</table>
<table border="0" cellpadding="0" cellspacing="0" width="100%%">
  <tr>
    <td align="left" class="footer">Generated by Epydoc
        3.0alpha3 on Wed Sep 20 12:10:44 2006</td>
    <td align="right" class="footer">
      <a href="http://epydoc.sourceforge.net">http://epydoc.sourceforge.net</a>
    </td>
  </tr>
</table>

<script type="text/javascript">
  <!--
  // Private objects are initially displayed (because if
  // javascript is turned off then we want them to be
  // visible); but by default, we want to hide them.  So hide
  // them unless we have a cookie that says to show them.
  checkCookie()
  // -->
</script>
  
</body>
</html>
